home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
United Public Domain Gold 2
/
United Public Domain Gold 2.iso
/
utilities
/
pu099.dms
/
pu099.adf
/
Doc-Files
/
XIP.doc
< prev
next >
Wrap
Text File
|
1989-07-22
|
21KB
|
596 lines
"XIP--Image Presentor", Copyright 1989, by Ralph Ciper
To execute this demo:
Enter "XIP XIP.doc" at the CLI prompt
-or-
use the "XIP.s" icon from workbench.
****************** Introduction to XIP *****************
* * * Prototype * * *
The "XIP--Image Presentor" has be presented ASIS, with no implied
or expressed warranties. Note: the term XIP in this document refers
to the XIP--Image Presentor program written by Ralph Ciper. If this
term is currently used by another product or service, the existence
was not know and infringement was not intended.
XIP is a computer based presentation system. Providing an video
presentation that could be controlled by the easily by a speaker was
the basis its design. Control of the images is accomplished by only
the mouse buttons and time interval. Currently the mouse controls
only forward movement, but later versions will allow the presenter
to show previously shown images.
Also to keep the audience's attention, XIP produces virtually an
unlimited number of screen transitions. These wipes can be from
the simple to the quite. With this feature, XIP is capable of
producing a spectacular self-running slide-show.
XIP features:
* Thousands of possible screen transitions.
* All Amiga IFF ILBM screen formats are handled:
Hi-res, Lo-res, Med-res, Interlaced, HAM,
Half-brite, and over-scan.
* CLI parameter or Command File control.
* Windowing.
* Mouse control.
* Double Buffering for make transitions as smooth or
crisp as desired.
* Execute CLI Commands while running.
***************** Registration Info ********************
If you like this product, please order a registered copy. The
registered copy will include the most enhanced version of XIP
available and a printed user guide. Support the share-ware
concept, send a $25 check to register to:
Tiffany Ciper
14337 Diplomat Dr.
Tampa, FL 33613
Please address any questions, comments or suggestions to Ralph Ciper
at the above address. I am interested in hearing your thoughts on
program, even if do not wish to contribute. You can also contact
me through Email on the Tampa Bay Amiga Group (TBAG) BBS 813-977-0941
in Tampa, Florida or at one of the Group Meetings.
********** Files Included in Demo Version *************
The following file are include with the archive file. Which originally
was posted on PeopleLink and The TBAG BBS. This copy may be freely
distributed in its archived form or placed on diskette provided that
all the files, except "iff.library", are placed in the same directory.
XIP The "XIP-Image Presentor" Program
XIP.doc XIP documentation. (also used as a demo command file)
"XIP.1" Logo Screen 1 (in quotes for XIP to know to display)
"XIP.2" Logo Screen 2 ''
XIP.s A simple CLI script file
XIP.s.info XICON icon for script
iff.library Christian Weber's IFF.library. Transfer to system library
"LIBS:" volume, if not already present.
************** Sections in This Document ***************
The following sections are in this document:
Introduction to XIP
Registration Info
Files Included with Demo
Sections in This Document
Quick Instructions
Wipe Definition
Window Definition
Tiling Definition
Control Commands
CLI Command Definitions
Command File Format
Distribution
Command File Demo
**************** Quick Instructions *******************
The prototype XIP can only be executed only from CLI. Please use ICONX
to execute using an Workbench icon. XIP.S and XIP.S.INFO are included
for Workbench users.
Format: "XIP command/... "
Where: <command> is any of the following:
IFF picture (ILBM) filename,
XIP control filename,
wipe definition,
window definition,
tiling definition,
process control command, or
a CLI command definition.
Any number of commands can be placed on a single CLI command line.
XIP will exit on the first invalid command or filename.
If a space in required in any filename or command enclose the entire
command in quotation marks (").
See the appropriate section for detail on format of definitions.
****************** Wipe Definitions ******************
The main power of XIP is the ability to combine wipes to form
an unlimited number of screen transitions. A wipe definition
is noted by starting with the symbol "@" then a series of
wipe instructions. For example "@r20" means wipe towards the
right in 20 steps; and "@d20r20" means wipe downward in 20 steps
and within each step wipe right in 20 steps. These combinations
can get quiet complicated as shown in the included demo script.
The basic wipe instructions are as follows:
Rn Wipe Right in <n> steps
Ln Wipe Left in <n> steps
Dn Wipe Down in <n> steps
Un Wipe Up in <n> steps
ARn Alternate between wiping Right and Left in <n> steps,
starting with a wipe right.
ALn As above except starting with a Wipe Left,
AUn Alternate between Up and Down wipes starting with Up.
ADn As above except starting with Down.
TRn After each wipe, turn wipe direction 90 degrees counter-
clockwize (i.e. Right then Up then Left then Down then
Right ... ). Start with wipe Right in <n> steps.
TLn As above but start with wipe Left.
TDn As above but start with wipe Down.
TUn As above but start with wipe Up.
CRn After each wipe, turn wipe direction 90 degrees clockwize
(i.e. Right then Down then Left then Up then Right ... ).
Start with wipe Right in <n> steps.
CLn As above but start with wipe Left.
CDn As above but start with wipe Down.
CUn As above but start with wipe Up.
IHn Wipe inward from the sides (Horizontally).
Note: this is actually done in n*2 steps.
IVn Wipe inward from the top and bottom (Vertically).
Note: this is actually done in n*2 steps.
IAn Wipe inward using <n> steps from all directions starting
with top and stepping clockwize. Note: takes n*4 steps.
In Wipe inward in <n> steps. Note: This must be the last
instruction in wipe definition.
OHn Wipe outward to the sides (Horizontally).
Note: this is actually done in n*2 steps.
OVn Wipe outward to the top and bottom (Vertically) in <n>
steps. Note this is actually done in n*2 steps.
OAn Wipe outward using <n> steps from all directions starting
with top and stepping clockwize. Note: takes n*4 steps.
On Wipe out from center in <n> steps. Note: This must be
the last instruction in wipe definition.
****************** Window Definitions ******************
XIP can restrict updating to a given area of a screen. This is
done be specifying a window of the screen.
Window specification uses the format:
(x,y,w,h) Where: X is horizontal position,
Y is vertical position,
W is horizontal size of window, and
H is vertical size.
Note: if W or H is omitted or zero, then size is set to center
the window on the screen in accordance with the missing
value.
*************** Tiling Definition ****************
The current window may divided into sections which are updated
concurrently by specifying a tiling factor. This is done using
the format:
(H,V) Where: H is the number horizontal sections.
V in the number vertical sections
Notes: If either H,V is zero that number is not changed
from last setting. [default if tiling off (1,1)]
(S) Where: S is the number of section horizontal and vertical
****************** XIP Control Commands *****************
XIP commands are used to control various aspects of program operation
and screen control.
Double buffering will only when chip memory is available to do so.
-D Disables double buffering
+D Enables double buffering [default]
The left mouse button is used for stopping a screen transition and
optionally control the presentation speed.
-M Disables mouse button control.
+M Enables mouse button control. [default]
The display speed can be regulated with the use of W command
+Wn Wait <n>/10th seconds between pictures [default 40]
-Wn Wait <n>/50th seconds between screen updates. [default zero]
The progress of the presentation can be monitored using the verbose (V)
control. When activated it will display (to standard output) each
parameter as it processed.
+V Activate the parameter processing monitor
-V Cancel the parameter processing monitor [default]
When creating a command file you may find it helpful to use the
test option in XIP. When enabled, the command file lines are sent
to the standard output. Then before each screen transition, the
WorkBench screen is display and you are prompted to continue or not.
To display next screen, press return; to skip a number of breakpoints
press a corresponding number of spaces before pressing return.
+T Display each line processed in parameter file
-T Suppress display of parameter [default]
The current window can be made a solid color or the current colors
can be inverted with the use of the Color command (C).
+Cn Fill the screen with color in register <n>.
-C Inverts the color registers used in current window.
*************** CLI Command Definition *****************
XIP is capable of executing CLI commands while during a processing.
The command is executed at the same time as the execution of XIP.
Format: "=cmdline" where cmdline is a CLI command with parameters.
Note: If there is spaces in the command line enclose the
command and the equal sign in quotes.
*************** Command File Format *****************
XIP can be controlled by a command file. This file can contain any
parameters that can be given on the CLI command line. The file is
Format: "command comment"
command an optional command which, if given, must start in
the first position and be one of the following:
a process control command,
a IFF picture (ILBM) filename,
a XIP control filename,
a wipe definition,
a window definition,
a tiling definition, or
a CLI command definition.
comment separate with a space from command. If command contains
spaces, i.e. filename, enclose the command in quotes (").
If the first position of the line is a space the entire
line is counted as a comment.
********************* Distribution *********************
This is freely-distributable, but copyrighted, program. Without
written consent of the author, both the following restrictions must
be satisfied:
* All the following files are included, in their original
form as released by the author, with are contained on the
same diskette or included within a compressed archived file:
XIP This program, a image presentation program.
XIP.DOC Documentation and example script file.
XIP.S Command file for processing XIP.DOC
XIP.S.INFO An icon for using ICONX on XIP.S
XIP.1 Demonstration Picture
XIP.2 Demonstration Picture
* No fee is charged other than diskette, duplication and handling
cost; or standard connection charges. The total cost cannot be
over $10.
*************** XIP Command File Demo ******************
Note: the first two pictures are loaded in "Files ..." section.
@r160 wipe right in 160 steps;
(1) Update as single screen
xip.1 Reload first picture
@l20 Wipe left in 20 steps
@r20 wipe right in 20 steps
+w15 only wait a second and a half between pictures
-c Complement Picture
@r20 Wipe down in 20 steps
(2) split screen in a 2x2 matrix
-c1 Complement Picture Plane on only
(5) Split screen into 5x5 section
@d5ar4 wipe down in 20 steps
XIP.2 Reload first picture
(64) Split by 64
@al5 wipe left in 5 steps
-c2 Complement 2nd plane
-c1 complement colors
(8,5) make screen into 8x5 matrix
@o4 go out in 4 steps
-c complement colors
-w50 wait a second between draws
(100) Split by 100
@d2 wipe down in 2 steps
-c
(160) Split by 160
@r2 wipe right in 2 steps
+c
(50)
@d2
-w0 no more step waits while drawing
(1,1) Don't split screen
XIP.1
@r32d20 Wipe right using 32 steps, within each step
step wipe down in 20 steps
xip.2
@d20ar32 Wipe down using 20 steps, within each step
wipe alternating right (then left) in 20 steps
XIP.1
@d5ar32ad4 Wipe down using 5 steps, within each step
wipe alternating right (then left) in 32 steps, in those
wipe alternating down (then left) in 4 steps
XIP.2
@u5ar8au2 Wipe up using 5 steps, within each step
wipe alternating right (then left) in 8 steps, in those
wipe alternating up (then down) in 2 steps
-c invert screen
@ih1ad2 in horizontal in 1 step, within each half
wipe alternate down then up 2 steps, (Checker board)
-c1 invert screen first bit plane
(1,1) Stop Screen Splits
@r20l10 Left wipe in a right wipe
XIP.1
@u2al2ad5al4ad5al8 Told you there were thousands of wipes!!!
this wipe makes 1200 different updates
to the screen. Use wisely!!
-c1
@ih20 In horizontal in 20 steps
-c2
@iv5au20 In vertical in 5 steps, in each of the passed
alternate right (and left) with 20 steps
XIP.2
@ia20 Spiral in 20 bands
-c1
@ia5cr4 Spiral in 5 sweeps with
4 steps in each direction
-c2
@oa4cr10 Spiral out in 2 sweeps with
10 steps in each (4) direction
-c
(2) Split in 2
-c
(8,5) split in 4
xip.2
@o20 Step out in 20 steps
XIP.1
(1) No Splits
@oh10ov10 Out horizontally in 10 steps, with each step
step out vertically int 10 steps
-c
@iv10ih10 In vertically in 10 step out horizontally in 10 steps
+c2 Color Drark grey
@ih10ov10 in horizontally in 10 steps, with each step
step out vertically int 10 steps
-w0
xip.2
@r10ih10 Step right 10 step out, with in horizontally 10 steps
-w15
-c
(2) Split screep by 2 (horizontally and vertically)
@i5 Step in 5 steps
xip.2
(8,5) Split Screen into 8 horizontal and 5 vertical
@o20 Step out in 2 steps
-c
(32,20) 32x20 screen each area is (10x10) pixels
@ih1 In using 1 step and within that step alterate down and up steps
-c
(40,25) 40x25 screen matrix is (8x8) pixels
@o4 outwards in 4 steps
-c
-w50 wait a second between each step
(80,50) 80x50 screen matrix is (4x4) pixels
@r2 right in in two steps
-w turn wait off
xip.2
(1,1) Don't Divide screen
(,,,) Full screen
**** now for window processing ****
(15,101,290,81) Setup Window for updating:
horizontal position (x) = 15
vertical position (y) = 101
Window Width (w) = 290
Window Height (h) = 81
xip.1
@ No wipe just pop on
-C invert colors
xip.1
@r290 wipe right at single pixel pace;
xip.2
@ad81 wipe down at single pixel pace;
+w0 No wait
@o10 Wipe Out
+C3 Fill with color three (LtGrey)
+C1 Fill with color one (White)
(20,106,280,71) Setup Window for updating:
+C2 Fill with color two (DkGrey)
(25,111,270,61) Setup Window for updating:
+w10 Wait for a second
+C0 Fill with color zero (Black)
(30,116,260,51) Setup Window for updating;
xip.2
(15,101,290,81) Setup Window for updating:
@ih145 wipe in horizontall at single pixel pace;
-c invert picture
@ar29d27 Alternate right (then left)
-c1 invert picture first bit plane
Show as above window (don't forget it now a left wipe)
-c2
@ov81 wipe out vertically in single pixel pace
xip.1
@i290 wipe in pixel at a time
-c
@o87 wipe out in 87 steps
-c1
(10,3) section window into 10 horizontal and 3 vertical sections
@o29 step out in 29 steps (single pixel)
-c2
@ih29 in horizontal in single pixel steps (divided window)
xip.2
@ov27 out vertically in single pixel steps (divided window)
***** Example on how to make a presentation ****
(,,,) Full window
(1) No Screen Splits
+c Clear
+w5 Only a half second wait, after this update.
@u20 wipe right quickly
xip.1 Load First Picture
(60,0,216,75) "XIP"
@u20 wipe left quickly
+w10 Wait a second after finished
(46,78,239,19) "Image Presentor"
@u100
+w20 Wait 2 seconds after this statement
(0,186,320,13) "Copyright 1988 ..." statement
@r40 wipe right in 40 steps
+w10 wait a second between each feature
(127,105,71,8) "Features:"
@oh20 wipe out from center in 20 steps.
(24,117,132,10) "Handles..."
@r wipe right slowly
(24,127,127,10) "Thousands..."
(24,137,103,10) "Variable..."
(24,147,55,10) "Windowing"
+w1 these next two are together no wait
(24,157,86,8) "Command ..."
+w10 Back to waiting a second
(35,166,93,8)
(164,118,127,10) "... Double ..." (Right side of list)
+w0 the next windows are together
(164,128,129,9)
+w10
(176,137,82,10) "... Non Interuptable ..."
(164,147,134,10) "... IFF.library ..."
+w0
(164,157,122,9) "... $25 ..."
+w10
(176,166,120,10)
@i8 in in eight tests
(15,101,290,81) put border on box
+w50 wait 10 seconds
***** exampe use of step delay -w ****
xip.1
(1) No Splits
-w50 Take steps a second step intevals
@i4 Step inwards using 4 steps
(,,,) Full Window
+w30 Wait 3 seconds
***** slow spiral in to exit *****
+C Clear Screen;
-w wait off
+w10 wait a second after complete
@ia20cr5 Wipe in max steps